QuickTime 3 Reference

Previous | Chapter Top | Chapter Contents | Next

Controlling Sequence Grabber Components

SGGrabPict

QuickTime 1.6.1 added a new flag to the grabPictCurrentImage parameter for the SGGrabPict function.

enum {
    grabPictCurrentImage            = 4
};

Constant descriptions

grabPictCurrentImage
Set this flag to 1 to provide the fastest possible image capture. Although this flag may fail under certain circumstances, this failure is recoverable; it just will not return a picture. You can then call SGGrabPict again without the flag set. This routine does not pause the current preview or grab the next frame; it just causes the currently displayed image to be captured. It's a good idea to call SGPause before calling SGGrabPict with this flag.

SGGetMode

The SGGetMode function returns the mode for a sequence grabber component.

pascal ComponentResult SGGetMode (
                     SeqGrabComponent s,
                     Boolean *previewMode,
                     Boolean *recordMode);
s
Specifies the component instance that identifies your connection to the sequence grabber component. You obtain this value from the Component Manager's OpenDefaultComponent or OpenComponent function.
previewMode
Contains a pointer to a Boolean. The sequence grabber component sets this field to true if the component is in preview mode.
recordMode
Contains a pointer to a Boolean. The sequence grabber component sets this field to true if the component is in record mode.

DISCUSSION

The SGGetMode function provides a convenient mechanism for determining whether a sequence grabber component is in preview mode or record mode.


© 1997 Apple Computer, Inc.

Previous | Chapter Top | Chapter Contents | Next